Skip to content

improvement(search): steer Confluence native queries to siteSearch for topic lookups - #9742

Merged
waleedlatif1 merged 2 commits into
stagingfrom
improvement/confluence-sitesearch-guide
Nov 6, 2026
Merged

waleedlatif1 merged 2 commits into
stagingfrom
improvement/confluence-sitesearch-guide

Conversation

@waleedlatif1

@waleedlatif1 waleedlatif1 commented Nov 6, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

  • The Confluence native-query guide taught only text ~ / title ~, so assistants searching Confluence directly wrote ORed text ~ clauses. CQL returns those in no relevance order, which puts pages sharing one common word (e.g. an acronym mentioned in passing) ahead of the page about the topic.
  • The guide now leads with siteSearch ~, Confluence's relevance search, for topic, acronym and how-to lookups, and keeps text ~ / title ~ for exact strings. The example and the avoid line follow.
  • Plain (non-native) searches already fall back to siteSearch on overflow; native queries skip that fallback, so the guide is the only lever on that path.

Type of Change

  • Improvement

Testing

  • Blind A/B on 40 real assistant-written Confluence queries: each ran as written (ORed text ~ / title ~) and rewritten as one siteSearch over the same words; a model judge compared the top 5 for the user's question in both orders, counting a win only when both orders agreed. siteSearch won 21, text ~ won 1, 18 ties (34/40 order-consistent). text ~ returned nothing in 4 cases where siteSearch returned 5. The one loss was an exact identifier lookup, which the guide still routes to text ~.
  • Side by side on six real topic questions, type IN (page, blogpost) AND siteSearch ~ "<words>" put the page about the topic first in five; the ORed text ~ form led with pages that only mention a term. One was mixed (a short token fuzzy-matched a longer one).
  • Native siteSearch queries run through the existing native-CQL path unchanged (scope, pagination, page mapping).
  • vitest on providers.test.ts, application.test.ts, atlassian.test.ts: 117 passed. biome check on the changed file.

Checklist

  • Code follows project style guidelines
  • Self-reviewed my changes
  • Tests added/updated and passing (new tests pass the test-audit authoring gate)
  • No new warnings introduced
  • I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

@vercel

vercel Bot commented Nov 6, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated
docs Skipped Skipped Nov 6, 2026 7:10pm UTC

Request Review

@greptile-apps

greptile-apps Bot commented Nov 6, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerView in GreptileConfidence Score: 5/5

[Low impact] The PR appears safe to merge.

Summary

Updates the Confluence query guide to favor siteSearch ~ for topic searches.

  • The Confluence guide now steers topic searches toward relevance-ranked results.

Reviews (2) · Last reviewed commit: "improvement(search): describe text ~ as ..." · Reviewed by Greptile

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 1 file

Reply with feedback, questions, or to request a fix.

Turn on auto-fix | Re-trigger cubic

@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@greptile

@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@cubic-dev-ai review this PR

@cubic-dev-ai

cubic-dev-ai Bot commented Nov 6, 2026

Copy link
Copy Markdown
Contributor

@cubic-dev-ai review this PR

@waleedlatif1 I have started the AI code review. It will take a few minutes to complete.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 1 file

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Turn on auto-fix | Re-trigger cubic

@waleedlatif1
waleedlatif1 merged commit 37a8ad3 into staging Nov 6, 2026
62 checks passed
@waleedlatif1
waleedlatif1 deleted the improvement/confluence-sitesearch-guide branch November 6, 2026 19:13

This branch was previously deployed

1 inactive deployment
Preview — 453dae6c Deployed Nov 6, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant